home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr22 / ext2err.zip / EXT2ERR.DOC < prev    next >
Text File  |  1993-04-14  |  3KB  |  81 lines
  1.  
  2.  
  3.  
  4.  
  5.                   ┌─────────────────────────────────────┐
  6.                   │ EXTension-2-ERRorlevel EXT2ERR v1.0 │
  7.                   └─────────────────────────────────────┘
  8.                             Copyright (C)1992 R.Janorkar
  9.                                    Release date 08/20/92
  10.  
  11.         EXTension-2-ERRorlevel is a simple utility that translates a
  12.         file extension passed to it on the command line into a DOS
  13.         errorlevel. Operation is fully configurable through use of a
  14.         configuration file that lets you define which file extension
  15.         translates to what errorlevel.
  16.  
  17.         This utility was primarily written for use with automatic file
  18.         scanning on Wildcat BBSes, but has a wider variety of uses,
  19.         allowing branching within DOS BATCH files using IF ERRORLEVEL
  20.         statements.
  21.  
  22.         This software is Copyright (C)1992 R.Janorkar, all rights are
  23.         reserved. No fee is expected for using this software, distribute
  24.         freely. This software is provided with NO warrantees, expressed
  25.         or implied. Use it at your own risk. The author will NOT be
  26.         liable for any damages, direct or indirect, arising from the
  27.         ability or disability to use this software.
  28.  
  29.         Syntax:
  30.         EXT2ERR <d:\path\config.ext> <filespec.ext>
  31.  
  32.         where <d:\path\config.ext> is the full drive:\path\filename and
  33.         extension of the configuration file;
  34.         and <filespec.ext> is the actual filename and extension that is
  35.         to be evaluated.
  36.  
  37.         EXT2ERR uses a configuration file that allows you to specify
  38.         each file extension and the associated errorlevel to return.
  39.         This configuration file can be named anything, but must contain
  40.         the data in the following format:
  41.  
  42.         ZIP = 200
  43.         GIF = 100
  44.         TXT = 010
  45.  
  46.         The last line MUST end with a carriage return (ENTER), all
  47.         errorlevels MUST be in three digit format with leading zeros
  48.         when needed. Matches will be made on exact case matches ONLY,
  49.         the use of all CaPiTaLs (UPPER case) is recommended. Only one
  50.         entry per line, EXT2ERR is limited to matching ONLY three
  51.         character extensions.
  52.  
  53.         The filename.extension passed on the command line may contain a
  54.         full drive:\path specification too, but only the actual file
  55.         extension is evaluated. If no match is found an errorlevel of
  56.         ZERO is returned.
  57.  
  58.         One must keep in mind the strange method that DOS uses for
  59.         evaluating errorlevels in BATch files. This statement:
  60.  
  61.         IF ERRORLEVEL 100 GOTO LABEL100
  62.  
  63.         will branch if the errorlevel is EQUAL TO OR GREATER than 100.
  64.         So an errorlevel of 101 will still be evaluated as true. The
  65.         only acceptable method of using errorlevels in BATch files is to
  66.         start with the highest errorlevel and count backwards:
  67.  
  68.         IF ERRORLEVEL 101 GOTO LABEL101
  69.         IF ERRORLEVEL 100 GOTO LABEL100
  70.         IF ERRORLEVEL 99 GOTO LABEL99
  71.  
  72.         please refer to you DOS documentation for more information.
  73.         EXT2ERR can set errorlevels from 0 to 255.
  74.  
  75.         If there are any problems, bugs or suggestions, you can contact
  76.         the author on the Photographers Network BBS (718) 876-0337.
  77.  
  78.  
  79.  
  80.  
  81.